﻿//===============================================================================
// Microsoft patterns & practices Enterprise Library Contribution
// Mapping Application Block
//===============================================================================

using Microsoft.Practices.EnterpriseLibrary.Common.Configuration;
using Microsoft.Practices.EnterpriseLibrary.Common.Configuration.ObjectBuilder;
using Microsoft.Practices.ObjectBuilder2;
using EntLibContrib.Mapping.Maps;

namespace EntLibContrib.Mapping.Configuration
{
	/// <summary>
	/// This type supports the Enterprise Library infrastructure and is not intended to be used directly from your code.
	/// Represents the process to build a <see cref="Map"/> described by a <see cref="MapData"/> configuration object.
	/// </summary>
	/// <remarks>This type is linked to the <see cref="MapData"/> type and it is used by the <see cref="MapCustomFactory"/> 
	/// to build the specific <see cref="IMap"/> object represented by the configuration object.
	/// </remarks>	
	public class MapAssembler : IAssembler<IMap, MapData>
	{
		#region Public Methods
		/// <summary>
		/// This method supports the Enterprise Library infrastructure and is not intended to be used directly from your code.
		/// Builds a <see cref="IMap"/> based on an instance of <see cref="MapData"/>.
		/// </summary>
		/// <param name="context">The <see cref="IBuilderContext"/> that represents the current building process.</param>
		/// <param name="objectConfiguration">The configuration object that describes the object to build. Must be an instance of <see cref="MapData"/>.</param>
		/// <param name="configurationSource">The source for configuration objects.</param>
		/// <param name="reflectionCache">The cache to use retrieving reflection information.</param>
		/// <returns>
		/// A fully initialized instance of <see cref="Map"/>.
		/// </returns>
		/// <seealso cref="MapCustomFactory"/>
		public IMap Assemble(IBuilderContext context,
												MapData objectConfiguration,
												IConfigurationSource configurationSource,
												ConfigurationReflectionCache reflectionCache)
		{
			// cast the configuration data to the specifc data type
			MapData castObjectConfiguration = (MapData)objectConfiguration;

			// create the map
			IMap createdObject = new Map(castObjectConfiguration.Name,
																	castObjectConfiguration.ColumnName);
			// return the fully built and populated map object
			return createdObject;
		}
		#endregion
	}
}
